home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 2004 May / SGI IRIX 6.5 Applications 2004 May.iso / dist / java3d.idb / usr / demos / java / j3d / programs / examples / ConfiguredUniverse / README.txt.z / README.txt
Encoding:
Text File  |  2003-08-08  |  6.2 KB  |  138 lines
  1. /*
  2.  *    @(#)README.txt 1.1 01/10/19 20:44:35
  3.  *
  4.  * Copyright (c) 1996-2001 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Redistribution and use in source and binary forms, with or without
  7.  * modification, are permitted provided that the following conditions
  8.  * are met:
  9.  *
  10.  * - Redistributions of source code must retain the above copyright
  11.  *   notice, this list of conditions and the following disclaimer.
  12.  *
  13.  * - Redistribution in binary form must reproduce the above copyright
  14.  *   notice, this list of conditions and the following disclaimer in
  15.  *   the documentation and/or other materials provided with the
  16.  *   distribution.
  17.  *
  18.  * Neither the name of Sun Microsystems, Inc. or the names of
  19.  * contributors may be used to endorse or promote products derived
  20.  * from this software without specific prior written permission.
  21.  *
  22.  * This software is provided "AS IS," without a warranty of any
  23.  * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
  24.  * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
  25.  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
  26.  * EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES
  27.  * SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  28.  * DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN
  29.  * OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR
  30.  * FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
  31.  * PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF
  32.  * LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE,
  33.  * EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  34.  *
  35.  * You acknowledge that Software is not designed,licensed or intended
  36.  * for use in the design, construction, operation or maintenance of
  37.  * any nuclear facility.
  38.  */
  39.  
  40. This directory contains a simple example application that demonstrates the
  41. ConfiguredUniverse utility class available in the com.sun.j3d.utils.universe
  42. package.  J3DFly, available separately, is a fully featured application that
  43. also uses ConfiguredUniverse.
  44.  
  45. ConfiguredUniverse is an extension of SimpleUniverse that can set up an
  46. interactive viewing environment based upon the contents of a site-specific
  47. configuration file.  This is useful when an application needs to run without
  48. change across a broad range of viewing configurations and locally available
  49. input and audio devices.  InputDevice implementations can be instantiated by
  50. ConfiguredUniverse and their Sensors can be retrieved by applications along
  51. with the names bound to them in the configuration file.
  52.  
  53. Supported viewing configurations include windows on conventional desktops,
  54. stereo-enabled views, fullscreen immersive displays on single or multiple
  55. screens, and virtual reality installations such as cave and head-mounted
  56. displays incorporating 6-degree-of-freedom sensor devices.
  57.  
  58. The ConfigObjLoad application is a modified version of the ObjLoad example
  59. program which uses the ConfiguredUniverse utility instead of SimpleUniverse.
  60. It also differs in the following other respects:
  61.  
  62.     It is an application and cannot be run in a browser.  ConfiguredUniverse
  63.     creates a JFrame, JPanel, and Canvas3D itself for each screen and is
  64.     oriented towards multiple fullscreen viewing environments, although
  65.     conventional windowed displays are also supported.  The components
  66.     created are easily accessable so applications can still incorporate them
  67.     into their own user interfaces.
  68.  
  69.     The configuration file to load is specified by the j3d.configURL
  70.     property.  If one is not specified, it will load the file j3d1x1-window
  71.     in this directory.
  72.  
  73.     Alternative custom view platform behaviors other than OrbitBehavior can
  74.     be used by specifying the behavior in the configuration file.
  75.  
  76.     It can retrieve a 6DOF Sensor specified in the configuration file and
  77.     use it to demonstrate the Mouse6DPointerBehavior class.
  78.  
  79.     Typing a "q" or the Escape key will terminate the example program.  This
  80.     is useful for fullscreen configurations.
  81.  
  82. To load a specific configuration file, set the j3d.configURL property on the
  83. command line:
  84.  
  85.     java -Dj3d.configURL=<URL string> ConfigObjLoad <args> <obj file>
  86.  
  87. For example, to load j3d1x2-rot30 in the current directory, run
  88.  
  89.     java -Dj3d.configURL=file:j3d1x2-rot30 ConfigObjLoad <args> <obj file>
  90.  
  91. This directory includes the following sample configuration files.  Normally
  92. a configuration file is site-specific but many of these can used as-is.
  93. Others may need customization for screen sizes, available input devices, and
  94. PhysicalBody parameters.
  95.  
  96.     j3d1x1: single fullscreen desktop configuration.
  97.     
  98.     j3d1x1-behavior: single fullscreen desktop configuration with a
  99.     configurable view platform behavior.
  100.  
  101.     j3d1x1-stereo: single fullscreen desktop configuration with stereo
  102.     viewing.     
  103.  
  104.     j3d1x1-vr: single fullscreen desktop configuration with stereo viewing,
  105.     head tracker, and 6DOF mouse.
  106.  
  107.     j3d1x1-window: single screen windowed desktop configuration.
  108.  
  109.     j3d1x2-flat: dual-screen flat desktop configuration.
  110.  
  111.     j3d1x2-rot30: dual-screen desktop configuration with each screen rotated
  112.     toward the other by 30 degrees about Y.
  113.  
  114.     j3d1x3-cave: 3-projector configuration with screens to the left, front,
  115.     and right of the user.
  116.  
  117.     j3d1x3-cave-vr: 3-projector configuration with screens to the left,
  118.     front, and right of the user.  Includes head tracking and stereo
  119.     viewing.
  120.  
  121.     j3d1x3-rot45: 3-screen desktop configuration with left and right screens
  122.     angled by 45 degrees from the center screen.
  123.  
  124.     j3d2x2-flat: 4-screen projector configuration arranged in a 2x2 power
  125.     wall. 
  126.  
  127. Note: JDK 1.4 or newer is required when configuring multiple screens if the
  128. X11 Xinerama extension is being used to create a single virtual screen.
  129. This is due to a limitation of the getScreenDevices() method in the JDK 1.3
  130. version of GraphicsConfiguration which returns only a single GraphicsDevice
  131. from a virtual screen.  ConfiguredUniverse will report this condition as an
  132. error in specifying more screens than are available.
  133.  
  134. Also: Graphics performance may be degraded in some environments when using a
  135. virtual screen device.  See the description of the j3d.disableXinerama
  136. property for possible performance improvements when using Xinerama.
  137.  
  138.